home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / q_mess.zip / Q_MESS.DOC next >
Text File  |  1990-08-19  |  14KB  |  313 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.           ▒▒▒▒▒▒▒             ▒▒    ▒▒▄  ▒▒▒▒▒▒▄  ▒▒▒▒▒▒▄  ▒▒▒▒▒▒▄
  15.           ▒▒█▀▀▒▒▄            ▒▒▒  ▒▒▒█  ▒▒█▀▀▀▀  ▒▒█▀▀▀▀  ▒▒█▀▀▀▀
  16.           ▒▒█  ▒▒█            ▒▒█▒▒█▒▒█  ▒▒▒▒▒▄   ▒▒▒▒▒▒▄  ▒▒▒▒▒▒▄
  17.           ▒▒█ ▒▒▒█            ▒▒█ ▀▀▒▒█  ▒▒█▀▀▀       ▒▒█      ▒▒█
  18.           ▒▒▒▒▒▒▒█   ▒▒▒▒▄    ▒▒█   ▒▒█  ▒▒▒▒▒▒▄  ▒▒▒▒▒▒█  ▒▒▒▒▒▒█
  19.            ▀▀▀▀▒▒█    ▀▀▀▀     ▀▀    ▀▀   ▀▀▀▀▀▀   ▀▀▀▀▀▀   ▀▀▀▀▀▀
  20.                 ▀▀
  21.                    Call/Message Ratio Checker for QuickBBS
  22.  
  23.                                  Version 1.21E
  24.  
  25.  
  26.                       Copyright (C) 1990 by Alain Poupart
  27.  
  28.                                All Rights Reserved
  29.  
  30.  
  31.  
  32. ╓─────────────────────────────────────────────────────────────────────────────╖
  33. ║ ░░░░░░░ Introduction ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  34. ╙─────────────────────────────────────────────────────────────────────────────╜
  35.  
  36.    This program works ONLY with QuickBBS only !!! ( special request )
  37.    The Remote Acces version is also available under the name of RA_MESS*
  38.    If you are willing to test this version with QuickBBS, it's all yours....
  39.    but don't complain to me if it doesn't work or leave some garbage.....
  40.     You have been notified.... so now.... I can rest in Peace...
  41.  
  42.  
  43. ╓─────────────────────────────────────────────────────────────────────────────╖
  44. ║ ░░░░░░░ Purposes ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  45. ╙─────────────────────────────────────────────────────────────────────────────╜
  46.  
  47.  
  48.    Have you ever thought of a BBS where users can download "freely" without
  49.   the stress of beeing obliged to upload something to keep up with the ratio.
  50.   (Most of the time,we end up with 2 or 3 versions of the same files - renammed
  51.                 or with 5 year old (or more) programs....)
  52.    What is type of user that most of us are looking for, the one that is active
  53.   in the message bases.... but how do we differentiate between the "desirable"
  54.   and the "less desirable" user.... Here comes Q-mess .....
  55.  
  56.    Q-Mess sets user security levels or flags based on the ratio of the
  57.    average number of calls per message posted on the board.
  58.  
  59.    Features include:
  60.  
  61.       - delete users at or below a pre-determined level.
  62.            ( Level 0 and "No Kill user are not affected)
  63.  
  64.       - delete users that have not called for a pre-determined number of days
  65.  
  66.       - Bonus VIP level for the one that maintains an average of one message
  67.         per call. However, they won't stay there if they slow down.
  68.  
  69.       - make charts of users "in danger" - QBMESS.ANS & QBMESS.ASC
  70.  
  71.       - keep track of of the changes to user's record ---> RATIO.LOG
  72.  
  73.       - REAL VIP users with VIP Flag turned ON are not affected by Q_MESS
  74.          (excepted if they haven't called for a set period of time)
  75.  
  76.       - you can elect to use the flag mode or the security level mode
  77.         (or both) to differentiate users that are above or below ratio
  78.  
  79. ╓─────────────────────────────────────────────────────────────────────────────╖
  80. ║ ░░░░░░░ Utilization ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  81. ╙─────────────────────────────────────────────────────────────────────────────╜
  82.  
  83.    Q-Mess , once registered, can be used unattended in the main batch file
  84.    after a user log off, or during your daily maintenance...
  85.    In either case, registered or not, it can be run attended at the dos prompt.
  86.  
  87.    Syntax:
  88.  
  89. [d:\path\]Q_mess Ram3 llow10 lnor20 lvip50 FnorD1 FlowC5 Del30 Kil5 Log FvipB2
  90.  
  91.    IMPORTANT:
  92.     it must be run form the same directory that contains the following files:
  93.            Config.Bbs, Users.Bbs, Lastread.Bbs, Combined.Bbs
  94.  
  95. ╓─────────────────────────────────────────────────────────────────────────────╖
  96. ║ ░░░░░░░ Parameters ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  97. ╙─────────────────────────────────────────────────────────────────────────────╜
  98.  
  99.    RAM  Number of calls per message posted
  100.             - ex: RAM3 ===> 3 calls for 1 message
  101.  
  102.    LLOW  Retrogradation level
  103.             - ex: LLOW10 ==> level 10 if message ratio below minimum required
  104.  
  105.    LNOR  Normal level for user keeping the message ratio
  106.             - ex: LNOR20 ==> level 20
  107.  
  108.    LVIP  Bonus Level
  109.             - ex: LVIP50 ==> users maintaining an average of one message
  110.                              per call are raised to level 50
  111.  
  112.    FLOW  Flag to switch on if ratio not meet
  113.             - ex: FLOWC5 ==> Flag C5 is on if user doesn't maintain
  114.                              the message ratio ( off if not )
  115.  
  116.    FNOR  Flag to switch on if ratio is OK
  117.             - ex: FNORD1 ==> Flag D1 is on if user maintain
  118.                              the message ratio ( off if not )
  119.  
  120.    FVIP  Flag to switch on to protect your real VIP
  121.             - ex: FVIPB2 ==> if Flag B2 is on, user will not be affected by
  122.                              the message ratio.
  123.  
  124.    DEL  Number of days without calling
  125.             - ex: DEL30 ==> delete all users that have not called for 30 days
  126.  
  127.    KIL  Devaldation level
  128.             - ex: KIL5  ==> delete all users with level 5 and less
  129.                                    ( level 0 excluded )
  130.  
  131.    LOG  Writes the Ratio.log files
  132.  
  133. ╓─────────────────────────────────────────────────────────────────────────────╖
  134. ║ ░░░░░░░ Default Value ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  135. ╙─────────────────────────────────────────────────────────────────────────────╜
  136.  
  137.     If some parameters are not mentionned on the command line, they will take
  138.     following value:
  139.  
  140.               RAM ==> 10
  141.              LLOW ==> 15  if Level used ( LVIP or LNOR) and LLOW missing
  142.              LNOR ==> 20  if Level used ( LVIP or LLOW) and LNOR missing
  143.              LVIP ==> 50  if Level used ( LNOR or LLOW) and LVIP missing
  144.  
  145.     if KIL, DEL, LOG, parameters are not used, these functions are ignored
  146.  
  147.     NOTE:  RAM parameter has a value of 3 till the program is registered
  148.            Ratio = 1000 indicates that a user has never posted
  149.  
  150. ╓─────────────────────────────────────────────────────────────────────────────╖
  151. ║ ░░░░░░░ Configuration ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  152. ╙─────────────────────────────────────────────────────────────────────────────╜
  153.  
  154.    None !!! with the exception of the parameters on the command line.
  155.  
  156.   Some typical command lines:
  157.  
  158.    Q_mess  Ram3 llow10 lnor20 lvip50 FlowC5 FnorD4 Del30 Kil5 FvipD1
  159.  
  160.        Average # calls per message posted to maintain: 3
  161.        User below Average...........: Level 10 - Flag C5 ON - Flag D4 OFF
  162.        User within the average......: Level 20 - Flag C5 OFF - Flag D4 ON
  163.        User with average 1 and less.: Level 50 - Flag C5 OFF - Flag D4 ON
  164.        User that has not called for the last 30 days..: Deleted
  165.          ( Except the one with NO KILL attribute turned to Y [yes] )
  166.        User at security level of 5 and less are deleted (except level 0)
  167.        Users witht D1 flag ON are not affected
  168.  
  169.    Q_mess  Ram3 FlowA5 FnorC4 Del30 FvipB3
  170.  
  171.        Average # calls per message posted to maintain: 3
  172.        User below Average...........:  Flag A5 ON - Flag C4 OFF
  173.        User within the average......:  Flag A5 OFF - Flag C4 ON
  174.        User that has not called for the last 30 days..: Deleted
  175.          ( Except the one with NO KILL attribute turned to Y [yes] )
  176.        Users witht B3 flag ON are not affected
  177.  
  178.    Q_mess  Ram5 llow10 lnor20 lvip50  Del30 FvipD1 Log
  179.  
  180.        Average # calls per message posted to maintain: 5
  181.        User below Average...........: Level 10
  182.        User within the average......: Level 20
  183.        User with average 1 and less.: Level 50
  184.        User that has not called for the last 30 days..: Deleted
  185.          ( Except the one with NO KILL attribute turned to Y [yes] )
  186.        Users witht D1 flag ON are not affected
  187.        Creates Ratio.log file
  188.  
  189. ╓─────────────────────────────────────────────────────────────────────────────╖
  190. ║ ░░░░░░░ Registration ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  191. ╙─────────────────────────────────────────────────────────────────────────────╜
  192.  
  193.    If you think that this program has a certain value to you and you are
  194.   willing to use it on a continuous basis, send me any donation you think it
  195.   worth, that will help me to cover the cost of software and books I bought
  196.   to develop Q_Mess and also to cover the phone charge to send you the
  197.   registration key.
  198.  
  199.    To receive the  key, you must forward to me the following informations:
  200.  
  201.                 - BBS's name
  202.                 - BBS's phone number
  203.                 - Sysop's name
  204.                 - an street address or FIDO node where to send the key.
  205.  
  206.      IMPORTANT:  The key is case sensitive, all informations must be given
  207.                  to me the same way as they appear in config.bbs
  208.  
  209.     registration procedure:
  210.  
  211.      copy the key file in the same directory as Q_Mess
  212.  
  213.      type in at dos prompt :     Q_Mess validation
  214.  
  215.  
  216.   (P.S. I leave it to you to decide what the program is worth.......)
  217.  
  218. ╓─────────────────────────────────────────────────────────────────────────────╖
  219. ║ ░░░░░░░ Credits ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  220. ╙─────────────────────────────────────────────────────────────────────────────╜
  221.  
  222.    I've to give most of the credit to my friend. She has been patient enough,
  223.    waiting for the completion of this program , sowe could take advantage of
  224.    the short summer with have here..... ( I've a Ra-Mess sun tan !!!)
  225.  
  226.    The other persons .....
  227.  
  228.     Aime Franche - Sysop of Le Courrier - 1:167/180 - St Lambert
  229.      "If it works for him ..... It must work for you ...!!!"
  230.  
  231.     Robert Laferte - One of the regular BBS user, who escaped several times
  232.       from dish washing and taking out the "green" bags, by trying to help
  233.       solve, over the phone, the @#%#%#$ pointer problems.
  234.  
  235.     Brent Corliss - Sysop Colonel Kitchen BBS - NH
  236.       He decides on his own to revise the doc to make it more "readable"
  237.       P.S. this portion has not been reviewed by him....
  238.  
  239.     Albert Afonso - Marquee System BBS - 1:266/18 - NJ
  240.       He comes up with so many good suggestions that I had to revise
  241.       the program, there was No way I could ignore them.....
  242.       I just hope this time, he will be satisfied with the changes.....
  243.  
  244. ╓─────────────────────────────────────────────────────────────────────────────╖
  245. ║ ░░░░░░░ The Final Word ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  246. ╙─────────────────────────────────────────────────────────────────────────────╜
  247.  
  248.    This program has given me an excellent opportunity learn Turbo C.
  249.    I was comfortable programing in some other languages ( even Lisp ), but
  250.    this time,I was willing to produce something more usefull than "hello world"
  251.    with the C language. The Books have suffered a lot,
  252.    the Programmer as well...but the product is here....
  253.    Also I was fed up with users complaining about their file transfers...
  254.    duplicates, aborted transfers, etc..... now no more complaints....
  255.  
  256.           I hope you will enjoy the features of this program
  257.  
  258.  
  259.                                Alain Poupart
  260.  
  261. ╓─────────────────────────────────────────────────────────────────────────────╖
  262. ║      Comments, suggestions, bug reports, donations, I can be reached at     ║
  263. ║                                                                             ║
  264. ║              2179 Dumouchel - Laval - Quebec - Canada - H7S 2H9             ║
  265. ║                                                                             ║
  266. ║   ██▓▓▒▒░░  JUNIOR BBS ░░▒▒▓▓██  1:167/118 ∞  514-687-6446   ≡ 24 hours ≡   ║
  267. ╙─────────────────────────────────────────────────────────────────────────────╜
  268.  
  269. ╓─────────────────────────────────────────────────────────────────────────────╖
  270. ║ ░░░░░░░ Revisions ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  271. ╙─────────────────────────────────────────────────────────────────────────────╜
  272.    Version 1.0  - July 1st,1990
  273.                The original version.......
  274.  
  275.    Version 1.1  - July 15th,1990
  276.                This is the proof that someone is using it or interested at it
  277.  
  278.                Flexibiliy added....
  279.                   Now you can select the way you want to make the difference
  280.                between "good" users and the "bad" one
  281.                   Security level LNOR and LLOW are now otpional as well as
  282.                FLOW and FNOR, you can use any combination of flag only,
  283.                security level only, or both flag and security level
  284.                   Logging is now optional.
  285.  
  286.    Version 1.2  - July 22nd,1990
  287.  
  288.                 Bugs removed:
  289.                  First of all, some of the parameters described int the doc
  290.                 where wrong because I'm working in parallel on the french and
  291.                 the english version.
  292.  
  293.                 Removed:
  294.                  The NOP option has been removed, now, I no longer have to write
  295.                 proprietary data in the users.bbs file
  296.  
  297.                 Revised:
  298.                   VIP level
  299.                   Real VIP can be protected by using a flag that you have to
  300.                 turn ON manually in user's record that you want to treat as
  301.                 a real VIP. The FVIP parameter has been added to identified them
  302.  
  303.                   VIP security level is now just a bonus level for the one that
  304.                 keep a call/message ratio of 1 and less but they dont'have any
  305.                 kind of protection.... it's just a way to give them more time
  306.                 or more Kilobytes in your LIMITS.CTL
  307.  
  308.    Version 1.21 - Aug. 19th,1990
  309.  
  310.                   It's not really a revision, but an other version for
  311.                  QuickBBS program, the RA flavor is still in it, except that
  312.                  this version will look for config.BBS instead of config.RA
  313.